home *** CD-ROM | disk | FTP | other *** search
/ PD ROM 1 / PD ROM Volume I - Macintosh Software from BMUG (1988).iso / Programming / Programming Tools / XCMDs / XCmdGlue.inc.c < prev    next >
Encoding:
Text File  |  1987-08-12  |  19.9 KB  |  712 lines  |  [TEXT/ttxt]
  1. /*
  2.     XCmdGlue.inc.c  Definitions for calling all standard 
  3.     HyperCard callback routines from C.  Include "HyperXCmd.h" 
  4.     before your program and this file after it.  Arguments are slightly 
  5.     different from Pascal.  The first argument is always a pointer to
  6.     the parameter block that HyperCard passed to the XCMD or XFCN.
  7.     This file derived from the Pascal interface, which is included as
  8.     comments.
  9.     
  10.       ©Apple Computer, Inc. 1987
  11.     All Rights Reserved.
  12.  
  13.     See CFlash.C for an example of how to include this module in your 
  14.     C program.
  15. */
  16.  
  17.  
  18. /*  Do a simple jump subroutine to a procedure with no arguments.  The 
  19.     address of the procedure is in the argument.   Declared above in 
  20.     HyperXCmd.h.  */
  21. /*    typedef void (*MyProcPtr) ();  */
  22. /*  PROCEDURE DoJsr(addr: ProcPtr); INLINE $205F,$4E90;  */
  23.  
  24.  
  25. pascal void SendCardMessage(paramPtr,msg)
  26.     XCmdBlockPtr    paramPtr;    StringPtr    msg;
  27.     /* Send a HyperCard message (a command with arguments) to the current card.
  28.        msg is a pointer to a Pascal format string.  */
  29. {
  30.     paramPtr->inArgs[0] = (long)msg;
  31.     paramPtr->request = xreqSendCardMessage;
  32.     ((MyProcPtr) (paramPtr->entryPoint))();
  33. }
  34. /*    PROCEDURE SendCardMessage(msg: Str255);
  35. BEGIN
  36.   WITH paramPtr^ DO
  37.     BEGIN
  38.       inArgs[1] := ORD(@msg);
  39.       request := xreqSendCardMessage;
  40.       DoJsr(entryPoint);
  41.     END;
  42. END;   */
  43.  
  44.  
  45.  
  46. pascal Handle EvalExpr(paramPtr,expr)
  47.     XCmdBlockPtr    paramPtr;    StringPtr    expr;
  48.     /* Evaluate a HyperCard expression and return the answer.  The answer is
  49.        a handle to a zero-terminated string. */
  50. {
  51.     paramPtr->inArgs[0] = (long)expr;
  52.     paramPtr->request = xreqEvalExpr;
  53.     ((MyProcPtr) (paramPtr->entryPoint))();
  54.     return (Handle)paramPtr->outArgs[0];
  55. }
  56. /*  FUNCTION EvalExpr(expr: Str255): Handle;
  57. BEGIN
  58.   WITH paramPtr^ DO
  59.     BEGIN
  60.       inArgs[1] := ORD(@expr);
  61.       request := xreqEvalExpr;
  62.       DoJsr(entryPoint);
  63.       EvalExpr := Handle(outArgs[1]);
  64.     END;
  65. END;   */
  66.  
  67.  
  68. pascal long StringLength(paramPtr,strPtr)
  69.     XCmdBlockPtr    paramPtr;    StringPtr    strPtr;
  70. /* Count the characters from where strPtr points until the next zero byte. 
  71.    Does not count the zero itself.  strPtr must be a zero-terminated string. */
  72. {
  73.     paramPtr->inArgs[0] = (long)strPtr;
  74.     paramPtr->request = xreqStringLength;
  75.     ((MyProcPtr) (paramPtr->entryPoint))();
  76.     return (long)paramPtr->outArgs[0];
  77. }
  78. /*    FUNCTION StringLength(strPtr: Ptr): LongInt;
  79. BEGIN
  80.   WITH paramPtr^ DO
  81.     BEGIN
  82.       inArgs[1] := ORD(strPtr);
  83.       request := xreqStringLength;
  84.       DoJsr(entryPoint);
  85.       StringLength := outArgs[1];
  86.     END;
  87. END;   */
  88.  
  89.  
  90. pascal Ptr StringMatch(paramPtr,pattern,target)
  91.     XCmdBlockPtr    paramPtr;    StringPtr    pattern;    Ptr    target;
  92. /* Perform case-insensitive match looking for pattern anywhere in
  93.    target, returning a pointer to first character of the first match,
  94.    in target or NIL if no match found.  pattern is a Pascal string,
  95.    and target is a zero-terminated string. */
  96. {
  97.     paramPtr->inArgs[0] = (long)pattern;
  98.     paramPtr->inArgs[1] = (long)target;
  99.     paramPtr->request = xreqStringMatch;
  100.     ((MyProcPtr) (paramPtr->entryPoint))();
  101.     return (Ptr)paramPtr->outArgs[0];
  102. }
  103. /*    FUNCTION StringMatch(pattern: Str255; target: Ptr): Ptr;
  104. BEGIN
  105.   WITH paramPtr^ DO
  106.     BEGIN
  107.       inArgs[1] := ORD(@pattern);
  108.       inArgs[2] := ORD(target);
  109.       request := xreqStringMatch;
  110.       DoJsr(entryPoint);
  111.       StringMatch := Ptr(outArgs[1]);
  112.     END;
  113. END;   */
  114.  
  115.  
  116. pascal void SendHCMessage(paramPtr,msg)
  117.     XCmdBlockPtr    paramPtr;    StringPtr    msg;
  118.     /* Send a HyperCard message (a command with arguments) to HyperCard.
  119.        msg is a pointer to a Pascal format string.  */
  120. {
  121.     paramPtr->inArgs[0] = (long)msg;
  122.     paramPtr->request = xreqSendHCMessage;
  123.     ((MyProcPtr) (paramPtr->entryPoint))();
  124. }
  125. /*    PROCEDURE SendHCMessage(msg: Str255);
  126. BEGIN
  127.   WITH paramPtr^ DO
  128.     BEGIN
  129.       inArgs[1] := ORD(@msg);
  130.       request := xreqSendHCMessage;
  131.       DoJsr(entryPoint);
  132.     END;
  133. END;    */
  134.  
  135.  
  136. pascal void ZeroBytes(paramPtr,dstPtr,longCount)
  137.     XCmdBlockPtr    paramPtr;    Ptr    dstPtr;    long    longCount;
  138. /* Write zeros into memory starting at destPtr and going for longCount 
  139.    number of bytes. */
  140. {
  141.     paramPtr->inArgs[0] = (long)dstPtr;
  142.     paramPtr->inArgs[1] = longCount;
  143.     paramPtr->request = xreqZeroBytes;
  144.     ((MyProcPtr) (paramPtr->entryPoint))();
  145. }
  146. /*    PROCEDURE ZeroBytes(dstPtr: Ptr; longCount: LongInt);
  147. BEGIN
  148.   WITH paramPtr^ DO
  149.     BEGIN
  150.       inArgs[1] := ORD(dstPtr);
  151.       inArgs[2] := longCount;
  152.       request := xreqZeroBytes;
  153.       DoJsr(entryPoint);
  154.     END;
  155. END;   */
  156.  
  157.  
  158. pascal Handle PasToZero(paramPtr,pasStr)
  159.     XCmdBlockPtr    paramPtr;    StringPtr    pasStr;
  160. /* Convert a Pascal string to a zero-terminated string.  Returns a handle
  161.    to a new zero-terminated string.  The caller must dispose the handle.
  162.    You'll need to do this for any result or argument you send from 
  163.    your XCMD to HyperTalk. */
  164. {
  165.     paramPtr->inArgs[0] = (long)pasStr;
  166.     paramPtr->request = xreqPasToZero;
  167.     ((MyProcPtr) (paramPtr->entryPoint))();
  168.     return (Handle)paramPtr->outArgs[0];
  169. }
  170. /*    FUNCTION PasToZero(str: Str255): Handle;
  171. BEGIN
  172.   WITH paramPtr^ DO
  173.     BEGIN
  174.       inArgs[1] := ORD(@str);
  175.       request := xreqPasToZero;
  176.       DoJsr(entryPoint);
  177.       PasToZero := Handle(outArgs[1]);
  178.     END;
  179. END;   */
  180.  
  181.  
  182. pascal void ZeroToPas(paramPtr,zeroStr,pasStr)
  183.     XCmdBlockPtr    paramPtr;    char    *zeroStr;    StringPtr    pasStr;
  184. /* Fill the Pascal string with the contents of the zero-terminated
  185.    string.  You create the Pascal string and pass it in as a VAR 
  186.    parameter.  Useful for converting the arguments of any XCMD to 
  187.    Pascal strings. */
  188. {
  189.     paramPtr->inArgs[0] = (long)zeroStr;
  190.     paramPtr->inArgs[1] = (long)pasStr;
  191.     paramPtr->request = xreqZeroToPas;
  192.     ((MyProcPtr) (paramPtr->entryPoint))();
  193. }
  194. /*  PROCEDURE ZeroToPas(zeroStr: Ptr; VAR pasStr: Str255);
  195. BEGIN
  196.   WITH paramPtr^ DO
  197.     BEGIN
  198.       inArgs[1] := ORD(zeroStr);
  199.       inArgs[2] := ORD(@pasStr);
  200.       request := xreqZeroToPas;
  201.       DoJsr(entryPoint);
  202.     END;
  203. END;  */
  204.  
  205.  
  206. pascal long StrToLong(paramPtr,strPtr)
  207.     XCmdBlockPtr    paramPtr;    Str31 *    strPtr;
  208. /* Convert a string of ASCII decimal digits to an unsigned long integer. */
  209. {
  210.     paramPtr->inArgs[0] = (long)strPtr;
  211.     paramPtr->request = xreqStrToLong;
  212.     ((MyProcPtr) (paramPtr->entryPoint))();
  213.     return (long)paramPtr->outArgs[0];
  214. }
  215. /*    FUNCTION StrToLong(str: Str31): LongInt;
  216. BEGIN
  217.   WITH paramPtr^ DO
  218.     BEGIN
  219.       inArgs[1] := ORD(@str);
  220.       request := xreqStrToLong;
  221.       DoJsr(entryPoint);
  222.       StrToLong := outArgs[1];
  223.     END;
  224. END;   */
  225.  
  226.  
  227. pascal long StrToNum(paramPtr,str)
  228.     XCmdBlockPtr    paramPtr;    Str31 *     str;
  229. /* Convert a string of ASCII decimal digits to a signed long integer.
  230.    Negative sign is allowed. */
  231. {
  232.     paramPtr->inArgs[0] = (long)str;
  233.     paramPtr->request = xreqStrToNum;
  234.     ((MyProcPtr) (paramPtr->entryPoint))();
  235.     return paramPtr->outArgs[0];
  236. }
  237. /*    FUNCTION StrToNum(str: Str31): LongInt;
  238. BEGIN
  239.   WITH paramPtr^ DO
  240.     BEGIN
  241.       inArgs[1] := ORD(@str);
  242.       request := xreqStrToNum;
  243.       DoJsr(entryPoint);
  244.       StrToNum := outArgs[1];
  245.     END;
  246. END;  */
  247.  
  248.  
  249. pascal Boolean StrToBool(paramPtr,str)
  250.     XCmdBlockPtr    paramPtr;    Str31 *     str;
  251. /* Convert the Pascal strings 'true' and 'false' to booleans. */
  252. {
  253.     paramPtr->inArgs[0] = (long)str;
  254.     paramPtr->request = xreqStrToBool;
  255.     ((MyProcPtr) (paramPtr->entryPoint))();
  256.     return (Boolean)paramPtr->outArgs[0];
  257. }
  258. /*    FUNCTION StrToBool(str: Str31): BOOLEAN;
  259. BEGIN
  260.   WITH paramPtr^ DO
  261.     BEGIN
  262.       inArgs[1] := ORD(@str);
  263.       request := xreqStrToBool;
  264.       DoJsr(entryPoint);
  265.       StrToBool := BOOLEAN(outArgs[1]);
  266.     END;
  267. END;   */
  268.  
  269.  
  270. pascal void StrToExt(paramPtr,str,myext)
  271.     XCmdBlockPtr    paramPtr;    Str31 *     str;    extended *    myext;
  272.  /* Convert a string of ASCII decimal digits to an extended long integer.
  273.     Instead of returning a new extended, as Pascal does, it expects you 
  274.     to create myext and pass it in to be filled. */
  275. {
  276.     paramPtr->inArgs[0] = (long)str;
  277.     paramPtr->inArgs[1] = (long)myext;
  278.     paramPtr->request = xreqStrToExt;
  279.     ((MyProcPtr) (paramPtr->entryPoint))();
  280. }
  281. /*    FUNCTION StrToExt(str: Str31): Extended;
  282. VAR x: Extended;
  283. BEGIN
  284.   WITH paramPtr^ DO
  285.     BEGIN
  286.       inArgs[1] := ORD(@str);
  287.       inArgs[2] := ORD(@x);
  288.       request := xreqStrToExt;
  289.       DoJsr(entryPoint);
  290.       StrToExt := x;
  291.     END;
  292. END;   */
  293.  
  294.  
  295. pascal void LongToStr(paramPtr,posNum,mystr)
  296.     XCmdBlockPtr    paramPtr;    long     posNum;    Str31 *    mystr;
  297.  /* Convert an unsigned long integer to a Pascal string.  Instead of 
  298.     returning a new string, as Pascal does, it expects you to 
  299.     create mystr and pass it in to be filled. */
  300. {
  301.     paramPtr->inArgs[0] = (long)posNum;
  302.     paramPtr->inArgs[1] = (long)mystr;
  303.     paramPtr->request = xreqLongToStr;
  304.     ((MyProcPtr) (paramPtr->entryPoint))();
  305. }
  306. /*    FUNCTION LongToStr(posNum: LongInt): Str31;
  307. VAR str: Str31;
  308. BEGIN
  309.   WITH paramPtr^ DO
  310.     BEGIN
  311.       inArgs[1] := posNum;
  312.       inArgs[2] := ORD(@str);
  313.       request := xreqLongToStr;
  314.       DoJsr(entryPoint);
  315.       LongToStr := str;
  316.     END;
  317. END;   */
  318.  
  319.  
  320. pascal void NumToStr(paramPtr,num,mystr)
  321.     XCmdBlockPtr    paramPtr;    long     num;    Str31 *    mystr;
  322.  /* Convert a signed long integer to a Pascal string.  Instead of 
  323.     returning a new string, as Pascal does, it expects you to 
  324.     create mystr and pass it in to be filled. */
  325. {
  326.     paramPtr->inArgs[0] = num;
  327.     paramPtr->inArgs[1] = (long)mystr;
  328.     paramPtr->request = xreqNumToStr;
  329.     ((MyProcPtr) (paramPtr->entryPoint))();
  330. }
  331. /*    FUNCTION NumToStr(num: LongInt): Str31;
  332. VAR str: Str31;
  333. BEGIN
  334.   WITH paramPtr^ DO
  335.     BEGIN
  336.       inArgs[1] := num;
  337.       inArgs[2] := ORD(@str);
  338.       request := xreqNumToStr;
  339.       DoJsr(entryPoint);
  340.       NumToStr := str;
  341.     END;
  342. END;   */
  343.  
  344.  
  345. pascal void NumToHex(paramPtr,num,nDigits,mystr)
  346.     XCmdBlockPtr    paramPtr;    long     num;
  347.     short    nDigits;            Str31 *    mystr;
  348. /* Convert an unsigned long integer to a hexadecimal number and put it
  349.    into a Pascal string.  Instead of returning a new string, as 
  350.    Pascal does, it expects you to create mystr and pass it in to be filled. */
  351. {
  352.     paramPtr->inArgs[0] = num;
  353.     paramPtr->inArgs[1] = nDigits;
  354.     paramPtr->inArgs[2] = (long)mystr;
  355.     paramPtr->request = xreqNumToHex;
  356.     ((MyProcPtr) (paramPtr->entryPoint))();
  357. }
  358. /*    FUNCTION NumToHex(num: LongInt; nDigits: INTEGER): Str31;
  359. VAR str: Str31;
  360. BEGIN
  361.   WITH paramPtr^ DO
  362.     BEGIN
  363.       inArgs[1] := num;
  364.       inArgs[2] := nDigits;
  365.       inArgs[3] := ORD(@str);
  366.       request := xreqNumToHex;
  367.       DoJsr(entryPoint);
  368.       NumToHex := str;
  369.     END;
  370. END;   */
  371.  
  372.  
  373. pascal void BoolToStr(paramPtr,bool,mystr)
  374.     XCmdBlockPtr    paramPtr;    Boolean    bool;    Str31 *    mystr;
  375.  /* Convert a boolean to 'true' or 'false'.  Instead of returning 
  376.     a new string, as Pascal does, it expects you to create mystr
  377.     and pass it in to be filled. */
  378. {
  379.     paramPtr->inArgs[0] = (long)bool;
  380.     paramPtr->inArgs[1] = (long)mystr;
  381.     paramPtr->request = xreqBoolToStr;
  382.     ((MyProcPtr) (paramPtr->entryPoint))();
  383. }
  384. /*    FUNCTION BoolToStr(bool: BOOLEAN): Str31;
  385. VAR str: Str31;
  386. BEGIN
  387.   WITH paramPtr^ DO
  388.     BEGIN
  389.       inArgs[1] := LongInt(bool);
  390.       inArgs[2] := ORD(@str);
  391.       request := xreqBoolToStr;
  392.       DoJsr(entryPoint);
  393.       BoolToStr := str;
  394.     END;
  395. END;   */
  396.  
  397.  
  398. pascal void ExtToStr(paramPtr,myext,mystr)
  399.     XCmdBlockPtr    paramPtr;    extended *    myext;    Str31 *    mystr;
  400.  /* Convert an extended long integer to decimal digits in a string.  
  401.     Instead of returning a new string, as Pascal does, it expects 
  402.     you to create mystr and pass it in to be filled. */
  403. {
  404.     paramPtr->inArgs[0] = (long)myext;
  405.     paramPtr->inArgs[1] = (long)mystr;
  406.     paramPtr->request = xreqExtToStr;
  407.     ((MyProcPtr) (paramPtr->entryPoint))();
  408. }
  409. /*    FUNCTION ExtToStr(num: Extended): Str31;
  410. VAR str: Str31;
  411. BEGIN
  412.   WITH paramPtr^ DO
  413.     BEGIN
  414.       inArgs[1] := ORD(@num);
  415.       inArgs[2] := ORD(@str);
  416.       request := xreqExtToStr;
  417.       DoJsr(entryPoint);
  418.       ExtToStr := str;
  419.     END;
  420. END;   */
  421.  
  422.  
  423. pascal Handle GetGlobal(paramPtr,globName)
  424.     XCmdBlockPtr    paramPtr;    StringPtr    globName;
  425. /* Return a handle to a zero-terminated string containing the value of 
  426.    the specified HyperTalk global variable. */
  427. {
  428.     paramPtr->inArgs[0] = (long)globName;
  429.     paramPtr->request = xreqGetGlobal;
  430.     ((MyProcPtr) (paramPtr->entryPoint))();
  431.     return (Handle)paramPtr->outArgs[0];
  432. }
  433. /*    FUNCTION GetGlobal(globName: Str255): Handle;
  434. BEGIN
  435.   WITH paramPtr^ DO
  436.     BEGIN
  437.       inArgs[1] := ORD(@globName);
  438.       request := xreqGetGlobal;
  439.       DoJsr(entryPoint);
  440.       GetGlobal := Handle(outArgs[1]);
  441.     END;
  442. END;   */
  443.  
  444.  
  445. pascal void SetGlobal(paramPtr,globName,globValue)
  446.     XCmdBlockPtr    paramPtr;    StringPtr    globName;    Handle    globValue;
  447. /* Set the value of the specified HyperTalk global variable to be
  448.    the zero-terminated string in globValue.  The contents of the 
  449.    Handle are copied, so you must still dispose it afterwards.  */
  450. {
  451.     paramPtr->inArgs[0] = (long)globName;
  452.     paramPtr->inArgs[1] = (long)globValue;
  453.     paramPtr->request = xreqSetGlobal;
  454.     ((MyProcPtr) (paramPtr->entryPoint))();
  455. }
  456. /*    PROCEDURE SetGlobal(globName: Str255; globValue: Handle);
  457. BEGIN
  458.   WITH paramPtr^ DO
  459.     BEGIN
  460.       inArgs[1] := ORD(@globName);
  461.       inArgs[2] := ORD(globValue);
  462.       request := xreqSetGlobal;
  463.       DoJsr(entryPoint);
  464.     END;
  465. END;   */
  466.  
  467.  
  468. pascal Handle GetFieldByName(paramPtr,cardFieldFlag,fieldName)
  469.     XCmdBlockPtr    paramPtr;    Boolean    cardFieldFlag;
  470.     StringPtr    fieldName;
  471. /* Return a handle to a zero-terminated string containing the value of 
  472.    field fieldName on the current card.  You must dispose the handle. */
  473. {
  474.     paramPtr->inArgs[0] = (long)cardFieldFlag;
  475.     paramPtr->inArgs[1] = (long)fieldName;
  476.     paramPtr->request = xreqGetFieldByName;
  477.     ((MyProcPtr) (paramPtr->entryPoint))();
  478.     return (Handle)paramPtr->outArgs[0];
  479. }
  480. /*    FUNCTION GetFieldByName(cardFieldFlag: BOOLEAN; fieldName: Str255): Handle;
  481. BEGIN
  482.   WITH paramPtr^ DO
  483.     BEGIN
  484.       inArgs[1] := ORD(cardFieldFlag);
  485.       inArgs[2] := ORD(@fieldName);
  486.       request := xreqGetFieldByName;
  487.       DoJsr(entryPoint);
  488.       GetFieldByName := Handle(outArgs[1]);
  489.     END;
  490. END;   */
  491.  
  492.  
  493. pascal Handle GetFieldByNum(paramPtr,cardFieldFlag,fieldNum)
  494.     XCmdBlockPtr    paramPtr;    Boolean    cardFieldFlag;
  495.     short    fieldNum;
  496. /* Return a handle to a zero-terminated string containing the value of 
  497.    field fieldNum on the current card.  You must dispose the handle. */
  498. {
  499.     paramPtr->inArgs[0] = (long)cardFieldFlag;
  500.     paramPtr->inArgs[1] = fieldNum;
  501.     paramPtr->request = xreqGetFieldByNum;
  502.     ((MyProcPtr) (paramPtr->entryPoint))();
  503.     return (Handle)paramPtr->outArgs[0];
  504. }
  505. /*    FUNCTION GetFieldByNum(cardFieldFlag: BOOLEAN; fieldNum: INTEGER): Handle;
  506. BEGIN
  507.   WITH paramPtr^ DO
  508.     BEGIN
  509.       inArgs[1] := ORD(cardFieldFlag);
  510.       inArgs[2] := fieldNum;
  511.       request := xreqGetFieldByNum;
  512.       DoJsr(entryPoint);
  513.       GetFieldByNum := Handle(outArgs[1]);
  514.     END;
  515. END;   */
  516.  
  517.  
  518. pascal Handle GetFieldByID(paramPtr,cardFieldFlag,fieldID)
  519.     XCmdBlockPtr    paramPtr;    Boolean    cardFieldFlag;
  520.     short    fieldID;
  521. /* Return a handle to a zero-terminated string containing the value of 
  522.    the field whise ID is fieldID.  You must dispose the handle. */
  523. {
  524.     paramPtr->inArgs[0] = (long)cardFieldFlag;
  525.     paramPtr->inArgs[1] = fieldID;
  526.     paramPtr->request = xreqGetFieldByID;
  527.     ((MyProcPtr) (paramPtr->entryPoint))();
  528.     return (Handle)paramPtr->outArgs[0];
  529. }
  530. /*    FUNCTION GetFieldByID(cardFieldFlag: BOOLEAN; fieldID: INTEGER): Handle;
  531. BEGIN
  532.   WITH paramPtr^ DO
  533.     BEGIN
  534.       inArgs[1] := ORD(cardFieldFlag);
  535.       inArgs[2] := fieldID;
  536.       request := xreqGetFieldByID;
  537.       DoJsr(entryPoint);
  538.       GetFieldByID := Handle(outArgs[1]);
  539.     END;
  540. END;   */
  541.  
  542.  
  543. pascal void SetFieldByName(paramPtr,cardFieldFlag,fieldName,fieldVal)
  544.     XCmdBlockPtr    paramPtr;    Boolean    cardFieldFlag;
  545.     StringPtr    fieldName;    Handle    fieldVal;
  546. /* Set the value of field fieldName to be the zero-terminated string 
  547.    in fieldVal.  The contents of the Handle are copied, so you must 
  548.    still dispose it afterwards. */
  549. {
  550.     paramPtr->inArgs[0] = (long)cardFieldFlag;
  551.     paramPtr->inArgs[1] = (long)fieldName;
  552.     paramPtr->inArgs[2] = (long)fieldVal;
  553.     paramPtr->request = xreqSetFieldByName;
  554.     ((MyProcPtr) (paramPtr->entryPoint))();
  555. }
  556. /*    PROCEDURE SetFieldByName(cardFieldFlag: BOOLEAN; fieldName: Str255; fieldVal: Handle);
  557. BEGIN
  558.   WITH paramPtr^ DO
  559.     BEGIN
  560.       inArgs[1] := ORD(cardFieldFlag);
  561.       inArgs[2] := ORD(@fieldName);
  562.       inArgs[3] := ORD(fieldVal);
  563.       request := xreqSetFieldByName;
  564.       DoJsr(entryPoint);
  565.     END;
  566. END;   */
  567.  
  568.  
  569. pascal void SetFieldByNum(paramPtr,cardFieldFlag,fieldNum,fieldVal)
  570.     XCmdBlockPtr    paramPtr;    Boolean    cardFieldFlag;
  571.     short    fieldNum;            Handle    fieldVal;
  572. /* Set the value of field fieldNum to be the zero-terminated string 
  573.    in fieldVal.  The contents of the Handle are copied, so you must 
  574.    still dispose it afterwards. */
  575. {
  576.     paramPtr->inArgs[0] = (long)cardFieldFlag;
  577.     paramPtr->inArgs[1] = fieldNum;
  578.     paramPtr->inArgs[2] = (long)fieldVal;
  579.     paramPtr->request = xreqSetFieldByNum;
  580.     ((MyProcPtr) (paramPtr->entryPoint))();
  581. }
  582. /*    PROCEDURE SetFieldByNum(cardFieldFlag: BOOLEAN; fieldNum: INTEGER; fieldVal: Handle);
  583. BEGIN
  584.   WITH paramPtr^ DO
  585.     BEGIN
  586.       inArgs[1] := ORD(cardFieldFlag);
  587.       inArgs[2] := fieldNum;
  588.       inArgs[3] := ORD(fieldVal);
  589.       request := xreqSetFieldByNum;
  590.       DoJsr(entryPoint);
  591.     END;
  592. END;   */
  593.  
  594.  
  595. pascal void SetFieldByID(paramPtr,cardFieldFlag,fieldID,fieldVal)
  596.     XCmdBlockPtr    paramPtr;    Boolean    cardFieldFlag;
  597.     short    fieldID;            Handle    fieldVal;
  598. /* Set the value of the field whose ID is fieldID to be the zero-
  599.    terminated string in fieldVal.  The contents of the Handle are 
  600.    copied, so you must still dispose it afterwards. */
  601. {
  602.     paramPtr->inArgs[0] = (long)cardFieldFlag;
  603.     paramPtr->inArgs[1] = fieldID;
  604.     paramPtr->inArgs[2] = (long)fieldVal;
  605.     paramPtr->request = xreqSetFieldByID;
  606.     ((MyProcPtr) (paramPtr->entryPoint))();
  607. }
  608. /*    PROCEDURE SetFieldByID(cardFieldFlag: BOOLEAN; fieldID: INTEGER; fieldVal: Handle);
  609. BEGIN
  610.   WITH paramPtr^ DO
  611.     BEGIN
  612.       inArgs[1] := ORD(cardFieldFlag);
  613.       inArgs[2] := fieldID;
  614.       inArgs[3] := ORD(fieldVal);
  615.       request := xreqSetFieldByID;
  616.       DoJsr(entryPoint);
  617.     END;
  618. END;   */
  619.  
  620.  
  621. pascal Boolean StringEqual(paramPtr,str1,str2)
  622.     XCmdBlockPtr    paramPtr;    Str31 *     str1;    Str31 *     str2;
  623. /* Return true if the two strings have the same characters.  
  624.    Case insensitive compare of the strings. */
  625. {
  626.     paramPtr->inArgs[0] = (long)str1;
  627.     paramPtr->inArgs[1] = (long)str2;
  628.     paramPtr->request = xreqStringEqual;
  629.     ((MyProcPtr) (paramPtr->entryPoint))();
  630.     return (Boolean)paramPtr->outArgs[0];
  631. }
  632. /*    FUNCTION StringEqual(str1,str2: Str255): BOOLEAN;
  633. BEGIN
  634.   WITH paramPtr^ DO
  635.     BEGIN
  636.       inArgs[1] := ORD(@str1);
  637.       inArgs[2] := ORD(@str2);
  638.       request := xreqStringEqual;
  639.       DoJsr(entryPoint);
  640.       StringEqual := BOOLEAN(outArgs[1]);
  641.     END;
  642. END;   */
  643.  
  644.  
  645. pascal void ReturnToPas(paramPtr,zeroStr,pasStr)
  646.     XCmdBlockPtr    paramPtr;    Ptr    zeroStr;    StringPtr    pasStr;
  647. /* zeroStr points into a zero-terminated string.  Collect the 
  648.    characters from there to the next carriage Return and return 
  649.    them in the Pascal string pasStr.  If a Return is not found, 
  650.    collect chars until the end of the string. */
  651. {
  652.     paramPtr->inArgs[0] = (long)zeroStr;
  653.     paramPtr->inArgs[1] = (long)pasStr;
  654.     paramPtr->request = xreqReturnToPas;
  655.     ((MyProcPtr) (paramPtr->entryPoint))();
  656. }
  657. /*    PROCEDURE ReturnToPas(zeroStr: Ptr; VAR pasStr: Str255);
  658. BEGIN
  659.   WITH paramPtr^ DO
  660.     BEGIN
  661.       inArgs[1] := ORD(zeroStr);
  662.       inArgs[2] := ORD(@pasStr);
  663.       request := xreqReturnToPas;
  664.       DoJsr(entryPoint);
  665.     END;
  666. END;   */
  667.  
  668.  
  669. pascal void ScanToReturn(paramPtr,scanHndl)
  670.     XCmdBlockPtr    paramPtr;    Ptr *    scanHndl;
  671. /* Move the pointer scanPtr along a zero-terminated 
  672.    string until it points at a Return character
  673.    or a zero byte.  */
  674. {
  675.     paramPtr->inArgs[0] = (long)scanHndl;
  676.     paramPtr->request = xreqScanToReturn;
  677.     ((MyProcPtr) (paramPtr->entryPoint))();
  678. }
  679. /*    PROCEDURE ScanToReturn(VAR scanPtr: Ptr);
  680. BEGIN
  681.   WITH paramPtr^ DO
  682.     BEGIN
  683.       inArgs[1] := ORD(@scanPtr);
  684.       request := xreqScanToReturn;
  685.       DoJsr(entryPoint);
  686.     END;
  687. END;   */
  688.  
  689.  
  690. pascal void ScanToZero(paramPtr,scanHndl)
  691.     XCmdBlockPtr    paramPtr;    Ptr *    scanHndl;
  692. /* Move the pointer scanPtr along a zero-terminated 
  693.    string until it points at a zero byte.  */
  694. {
  695.     paramPtr->inArgs[0] = (long)scanHndl;
  696.     paramPtr->request = xreqScanToZero;
  697.     ((MyProcPtr) (paramPtr->entryPoint))();
  698. }
  699. /*    PROCEDURE ScanToZero(VAR scanPtr: Ptr);
  700. BEGIN
  701.   WITH paramPtr^ DO
  702.     BEGIN
  703.       inArgs[1] := ORD(@scanPtr);
  704.       request := xreqScanToZero;
  705.       DoJsr(entryPoint);
  706.     END;
  707. END;   */
  708.  
  709.  
  710.  
  711.  
  712.